home *** CD-ROM | disk | FTP | other *** search
/ Die Speccy' 97 / Die Speccy' 97.iso / amiga_system / the_aminet / util / misc / smartass_exe.lha / SmartAss / SmartAss.doc < prev    next >
Text File  |  1995-10-16  |  9KB  |  239 lines
  1. SmartAss V1.3 AMIGA by Hσvard "Howard" Pedersen
  2. ⌐ 1994-95 Mental Diseases
  3.  
  4. A program for the handling of fortunes upon startup.
  5.  
  6.  
  7. DISCLAIMER
  8.  
  9. I take no responsibility for what this program may to do you,
  10. your belongings, your family, your hometown, your (beloved/not
  11. beloved) pets or your mental state. Use entirely at your own
  12. risk. You may copy this program to any schmuck wanting it.
  13.  
  14. Please note that most of the quotes used by SmartAss does not
  15. include author information. It's hard to obtain this information
  16. on everything, so I've mostly let it out.
  17.  
  18. The fortunes presented here may be offensive to some. If you feel
  19. offended by any fortune, please notify me, and I will have it
  20. removed from the next distribution of SmartAss if I find it
  21. reasonable. Please keep in mind though, that no fortunes are ment
  22. to offend anyone, but rather to amuse and entertain. Not all
  23. fortunes herein represent my personal views. (Though most do! =)
  24.  
  25.  
  26. INTRODUCTION
  27.  
  28. SmartAss was originally written in annoyment over another
  29. fortune-program I found, WiseCrack. The program was written in C
  30. and both its random-number generator and speed was terrible. It
  31. wasn't meant to be the project it has become today. WiseCrack had
  32. originally 2393 fortunes, and to tell you the truth it sort of
  33. came out of control. SmartAss possessed me, and when my datafile
  34. counted over 19000 fortunes I realised I had made a MONSTER!
  35. (Spooky orchestral music here!) SmartAss offers you the following
  36. features:
  37.  
  38.         * The largest fortunecollection known to man. (19758!)
  39.         * Compatibility with SmartAss for Unix, DOS and Windows,
  40.           written by Sveinar Rasmussen.
  41.         * Really fast fortune-fetching due to hash-tables.
  42.         * Does NOT read entire datafile into memory.
  43.         * Has a continously updating fortunefile. (Available on
  44.           AmiNet!)
  45.         * Is able to print fortunes to standard output. Insert
  46.           SmartAss in your shell-startup or redirect to printer!
  47.         * Very random picking of fortunes!
  48.  
  49.  
  50. HOW TO USE
  51.  
  52. Starting SmartAss from WB is a breeze. Put it in your
  53. WBStartup-drawer or simply doubleclick on its icon. You should
  54. immediately (well, nearly) get an intuition-requester with the
  55. fortune selected. Unfortunately, current version does not support
  56. any arguments from icon. If this is important to you, you have to
  57. use IconX for now.
  58.  
  59. Starting it from CLI is as easy as from WB. Typing its name and
  60. pressing return will bring up the earlier mentioned requester. To
  61. make SmartAss type its output in the CLI window you need to write
  62. "SmartAss STDIO" and voila! The keyword PATH may be used to
  63. specify where to search for the datafiles. For example to fetch
  64. datafiles from "Text:" and print out the fortune to a printer you
  65. would type "SmartAss STDIO PATH Text: >PRT:" and consider it
  66. done.
  67.  
  68. Normally, SmartAss searches for it's datafiles in the S:
  69. directory. You must make sure that the file is a version 2
  70. datafile. This should be mentioned a small textfile accompanying
  71. the datafile.
  72.  
  73.  
  74. PROGRAM HISTORY
  75.  
  76. V1.0    Initial release. Written in annoyment of the lousy
  77.         random-calculation of WiseCrack. 2,467 fortunes, whereof
  78.         2,393 origins from WiseCrack. Limitations: 4,294,967,295
  79.         fortunes.
  80.         - COUNT keyword cause output of total number of fortunes
  81.           in datafile.
  82.         - STDOUT keyword cause fortunes to be output to standard
  83.           output. (Console window or via redirection to
  84.           whatever...)
  85.  
  86. V1.1    Speed raise attempt. Limitations: 65,535 files with
  87.         maximum 65,535 fortunes each, resulting in a maximum of
  88.         4,294,836,225 fortunes. Distributed datafile consists of
  89.         2,612 fortunes.
  90.         - Multiple datafiles now supported. Gains MUCH speed!
  91.         - Changed FILE/FROM keyword to PATH to simplify loading
  92.           of multiple datafiles.
  93.         - Count keyword removed. Will be released in separate
  94.           command soon.
  95.         - Started using BSS hunk for smaller objects.
  96.         - Drew me a nice icon for MagicWB.
  97.         - Fixed bug causing last fortune in a file to be
  98.           displayed in requester with a empty line at the
  99.           bottom.
  100.         - If attempting to display fortunes larger than 4K with
  101.           intuition requester, SmartAss would most likely crash.
  102.           Will now report error.
  103.  
  104. V1.2    Still not random enough. Error reports sucked!
  105.         Distributed datafiles consists of 6,036 fortunes. At this
  106.         time, Sveinar Rasmussen Made MS-DOS, Windows and Unix
  107.         versions of SmartAss.
  108.         - DisplayBeep() when displaying error messages, to
  109.           distinguish error-requesters from fortunes.
  110.         - Made random-calculation even more random.
  111.         - Potential bug-fix: SmartAss _could_ crash if an error
  112.           occured and intuition-library V36 or higher couldn't be
  113.           opened.
  114.         - Removed some fortunes which actually told you that OS/2
  115.           was a good OS! 8)
  116.         - Changed fortune introducer from "@" to a "~" on a
  117.           separate line.
  118.         - Created compiled fileformat with index for a massive
  119.           speed gain.
  120.         - Several different errorreports upon memory shortage, to
  121.           make bughunting easier.
  122.         - Due to my incredible slow routine for selecting the
  123.           fortune, I've set the fortune-limit to 65535.
  124.  
  125. V1.3!   Whoa! Major furtune update! Distributed datafiles
  126.         consists of 19,758 fortunes! And I'm announcing this
  127.         release as the exclamation-mark release! A
  128.         library-version is coming up!
  129.         - Encoded datafile to make it impossible to read from a
  130.           text-viewer! Version of file-format was set to 2 due to
  131.           this!
  132.         - Wrote documentation! (Finally!)
  133.  
  134.  
  135. THINGS TO COME IN FUTURE RELEASES
  136.  
  137. * Make stdout-parser translating linefeeds into double linefeeds
  138. (PC-style). This will cause SmartAss to work far better with
  139. terminals in mind.
  140.  
  141. * Improve random-calculations even more.
  142.  
  143. * BUGFIX! After a lot of fortune-reading, a "datafile corrupt"
  144. error appeared?
  145.  
  146. * Read WB tooltypes. (When I figure out how!) :(
  147.  
  148. * Environment variable to specify prefered settings.
  149.  
  150. * Write DOS-command to write statistics on the fortunefiles.
  151.  
  152. * Write AmigaGuide documentation.
  153.  
  154. * Public screen argument.
  155.  
  156. * Expand fortune-file.
  157.  
  158. * Build the friggin' window on my own, so I don't have to think
  159. about proportional fonts anymore.
  160.  
  161. * Remove usage of utility-library for random seeding.
  162.  
  163. * Use fixed huffman for fortune storage. (Smaller datafile!)
  164.  
  165. * Don't read more than necessary of index file.
  166.  
  167. * Make smartass-library to improve versatility and make it
  168. possible to write custom fortune-displayers. With this release I
  169. will simultaneously release:
  170.         - MUI fortune display.
  171.         - Intuition fortune display.
  172.         - DOS fortune display.
  173.         - Bootscreen utility with fortune display.
  174.  
  175. * Check fileformat better when reading index file.
  176.  
  177. * Homepage! It's there, but I can't remember the address.
  178.  
  179.  
  180. HOW TO GET THE NEWEST VERSION OF SMARTASS OR NEW DATAFILES
  181.  
  182. The newest Amiga version is always on AmiNet. The only server I
  183. remember right now is ftp.netnet.net, but there are a lot of
  184. mirrors. The executable and the datafiles are in separate
  185. archives for poor sods who only want new version of the program.
  186. :) New datafiles are continously uploaded here in LHA archives.
  187.  
  188. Another way to get a new version, read uninteresting stuff about
  189. SmartAss or find out what's coming up is checking out the
  190. SmartAss homepage! It's located at:
  191.  
  192.         http://www.cs.uit.no/~sveinarr
  193.  
  194. The link doesn't take you all the way, but there should be a
  195. SmartAss button somewhere. Click it! The SmartAss files on this
  196. page is actually located in USA. Europeans should therefore use
  197. AmiNet when possible, while Americans might find this quite a
  198. relief.
  199.  
  200.  
  201. CONTACTING THE AMIGA AUTHOR
  202.  
  203. I'm maintaining the Amiga version and does some work concerning
  204. fileformat and new fortunes. There is an italian guy who's
  205. working on a BIIIG expansion to the fortune file and checking the
  206. file for double storage of fortunes. Unfortunately I don't know
  207. his name nor any way to contact him. (Sveinar do!) Contact me if
  208. you've got ANYTHING to say about SmartAss:
  209.  
  210. E-Mail: (Preferably)
  211.         havardp@mail.stud.ingok.hitos.no
  212.  
  213. IRC: (Nice alternative!)
  214.         Nick: Howard, Howard_, Howard__
  215.         Channels: #amiga, #amigascne, #norge
  216.  
  217. Snail-mail: (If all else fails)
  218.         Hσvard Pedersen
  219.         Kvartsveien 175
  220.         N-9022  KROKELVDALEN
  221.         Norway
  222.  
  223.  
  224. CONTACTING THE UNIX/MSDOS/WINDOWS AUTHOR
  225.  
  226. Sveinar Rasmussen has made SmartAss for Windows, DOS and Unix. If
  227. you want this program you can either mail him or get it through
  228. the SmartAss home page. I'm sure he would also appreciate
  229. comments and other types of feedback on his efforts.
  230.  
  231. E-Mail:
  232.         sveinarr@stud.cs.uit.no
  233.  
  234.  
  235. LAST WORDS
  236.  
  237. Thanks to Frank Simonsen, who collected the imense amount of 50
  238. fortunes and insisted on getting credits for the work! Thanks
  239. pal! ;)